
Security News
vlt Launches "reproduce": A New Tool Challenging the Limits of Package Provenance
vlt's new "reproduce" tool verifies npm packages against their source code, outperforming traditional provenance adoption in the JavaScript ecosystem.
github-slugger
Advanced tools
The github-slugger npm package generates GitHub-style slugs from strings. These slugs are often used in URLs, markdown headers, and anywhere else where a simplified, URL-friendly identifier for a string is useful. It ensures uniqueness of the slugs within the same document or context by appending incrementing numbers when duplicates are generated.
Generate a slug from a string
This feature allows you to convert any string into a slug that is URL-friendly and resembles the slugs GitHub generates for markdown headers.
"const GithubSlugger = require('github-slugger');
const slugger = new GithubSlugger();
console.log(slugger.slug('Hello World')); // Outputs: 'hello-world'"
Generate unique slugs within the same instance
This demonstrates how github-slugger ensures uniqueness by appending incrementing numbers to slugs generated from identical strings within the same instance.
"const GithubSlugger = require('github-slugger');
const slugger = new GithubSlugger();
console.log(slugger.slug('Hello World')); // Outputs: 'hello-world'
console.log(slugger.slug('Hello World')); // Outputs: 'hello-world-1'"
Resetting the slugger
This feature shows how to reset the internal state of the slugger instance, allowing for the reuse of slugs that were previously incremented.
"const GithubSlugger = require('github-slugger');
const slugger = new GithubSlugger();
slugger.slug('Hello World');
slugger.reset();
console.log(slugger.slug('Hello World')); // Outputs: 'hello-world' again, after reset"
slugify is a similar package that converts strings into URL slugs. Compared to github-slugger, slugify offers more customization options, such as the ability to specify replacement characters, but it does not automatically handle uniqueness within the same context.
uslug is another package for generating slugs from strings. It focuses on creating slugs that are safe for URLs and readable. Unlike github-slugger, uslug does not automatically append numbers to ensure uniqueness, but it provides options for allowing certain special characters to be included.
Generate a slug just like GitHub does for markdown headings. It also ensures slugs are unique in the same way GitHub does it. The overall goal of this package is to emulate the way GitHub handles generating markdown heading anchors as close as possible.
This project is not a Markdown or HTML parser: passing alpha *bravo* charlie
or alpha <em>bravo</em> charlie
doesn’t work.
Instead pass the plain text value of the heading: alpha bravo charlie
.
npm install github-slugger
var GithubSlugger = require('github-slugger')
var slugger = new GithubSlugger()
slugger.slug('foo')
// returns 'foo'
slugger.slug('foo')
// returns 'foo-1'
slugger.slug('bar')
// returns 'bar'
slugger.slug('foo')
// returns 'foo-2'
slugger.slug('Привет non-latin 你好')
// returns 'привет-non-latin-你好'
slugger.slug('😄 emoji')
// returns '-emoji'
slugger.reset()
slugger.slug('foo')
// returns 'foo'
Check test/fixtures.json
for more examples.
If you need, you can also use the underlying implementation which does not keep track of the previously slugged strings (not recommended):
var slug = require('github-slugger').slug;
slug('foo bar baz')
// returns 'foo-bar-baz'
slug('foo bar baz')
// returns the same slug 'foo-bar-baz' because it does not keep track
Contributions welcome! Please read the contributing guidelines first.
1.5.0 2022-10-25
FAQs
Generate a slug just like GitHub does for markdown headings.
The npm package github-slugger receives a total of 4,130,240 weekly downloads. As such, github-slugger popularity was classified as popular.
We found that github-slugger demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 5 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
vlt's new "reproduce" tool verifies npm packages against their source code, outperforming traditional provenance adoption in the JavaScript ecosystem.
Research
Security News
Socket researchers uncovered a malicious PyPI package exploiting Deezer’s API to enable coordinated music piracy through API abuse and C2 server control.
Research
The Socket Research Team discovered a malicious npm package, '@ton-wallet/create', stealing cryptocurrency wallet keys from developers and users in the TON ecosystem.